Release 10.1A: OpenEdge Development:
Progress 4GL Reference

SET-PARAMETER( ) method

Lets you set parameters of one of the following:

A procedure or user-defined function you want to invoke dynamically.
An attribute you want to get or set dynamically.
A method you want to invoke dynamically.
Return type: LOGICAL
Applies to: CALL object handle

Syntax

SET-PARAMETER(parameter-number, data-type, iomode, parameter-value)

parameter-number

An INTEGER expression indicating the order of the parameter. Use 1 for the first parameter, 2 for the second parameter, and so on.

data-type

A CHARACTER expression indicating the data type of the parameter and evaluating to one of the following:

“CHARACTER”
“DATASET-HANDLE”
“DATE”
“DATETIME”
“DATETIME-TZ”
“DECIMAL”
“HANDLE”
“INTEGER”
“LOGICAL”
“LONGCHAR”
“MEMPTR”
“RAW”
“ROWID”
“TABLE-HANDLE”

TABLE-HANDLE can be a handle to a static or dynamic temp-table. Likewise, DATASET-HANDLE can be a handle to a static or dynamic ProDataSet object.

Note: To manage BUFFER parameters, use HANDLE parameters.

For each parameter, the data type specified by the caller and the callee must be compatible.

iomode

A CHARACTER expression indicating the mode of the parameter and evaluating to one of the following:

“INPUT”
“OUTPUT”
“INPUT-OUTPUT”
“OUTPUT-APPEND”

For each parameter, the mode specified by the caller and the callee must match.

For parameters of attributes, specify “INPUT.”

For TABLE-HANDLE output parameters whose output is to be appended to the table, and in no other case, specify “OUTPUT-APPEND.”

If data-type is “DATASET-HANDLE”, you can append "-by-reference" to any iomode listed above.

parameter-value

An expression whose type is compatible with data-type.

The parameter-value argument may represent a determinate or indeterminate array. However, you cannot pass an array by value. You can pass an array only as a variable defined using the DEFINE VARIABLE statement with the EXTENT option. If you include the EXTENT keyword in the data-type argument, Progress ignores it. If you include the array element values in the parameter-value argument, Progress generates a compile error.

If iomode is “INPUT” or “INPUT-OUTPUT,” if the data type of parameter-value does not agree with the data type passed, parameter-value will automatically be converted to the data type passed during SET-PARAMETER( ) processing.

If iomode is “OUTPUT” or “INPUT-OUTPUT,” each of the following must be true:

parameter-value must represent a program variable or a NO-UNDO TEMP-TABLE field (perhaps with an array reference).
parameter-value must still be in scope and must still be valid when the dynamic invoke is executed.

If the output value from the called procedure does not have a data type that matches the data type passed, the output value will be converted to the data type passed.

If iomode is “OUTPUT,” parameter-value is ignored if the ASYNCHRONOUS attribute is TRUE.